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DECLARATION OF BENJAMIN W. WYCKOFF UNDER 37 C.F.R. 1.131 

I, Benjamin W. Wyckoff, hereby declare: 

1 . That I am a co-inventor of the claims in the above-captioned patent application. 

2. That in an Office Action dated March 30, 2007, claims 7, 17, and 25 were rejected as 
being rendered obvious by the combination of Scherr, U.S. Patent 6,799,248, and Kredo, 
U.S. Patent No. 6,449,636, which has a priority date of September 8, 1999. 

3. That in an office action dated March 30, 2007, claims 6 and 24 were rejected as being 
rendered obvious by the combination of Scherr, U.S. Patent 6,799,248, and Nashed, U.S. 
Patent 6,654,749, which has a priority date of May 12, 2000. 

4. That on or before September 8, 1 999, in the United States, a WTO member country, we 
qonceived a method for enabling the generation of an updated web-page for storage in 
one of a plurality of cache servers, the method comprising: implementing programmable 
rules executing on each of the plurality of cache servers, each programmable rule 
defining a triggering event associated with its corresponding cache server, the occurrence 
of the triggering event being indicative of the existence of an obsolete portion of the web- 
page stored in the corresponding cache server; detecting an occurrence of a triggering 
event at a particular cache server selected from the plurality of cache servers; in response 
to the occurrence of the triggering event, causing the particular cache server to request an 
update of the obsolete portion; and receiving an updated portion of the web-page for 
storage at the particular cache server, wherein requesting an update included formulating 
a database query to be carried out by a database engine. 
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5. That on or before September 8, 1999, in the United States, a WTO member country, we 
conceived a computer-readable medium having encoded thereon software for updating 
web-pages stored in caches, each cache being associated with a corresponding cache 
server from a plurality of cache serves, the software comprising instructions for 
implementing programmable rules executing on each of the plurality of cache servers, 
each programmable rule defining a triggering event associated with its corresponding 
cache server, the occurrence of the triggering event being indicative of the existence of an 
obsolete portion of the web-page stored in the corresponding cache server; detecting an 
occurrence of a triggering event at a particular cache server selected from the plurality of 
cache servers; in response to the occurrence of the triggering event, causing the particular 
cache server to request an update of the obsolete portion; and receiving an updated 
portion of the web-page for storage at the particular cache server, wherein the instructions 
for requesting an updated portion of the web page included instructions for formulating a 
database query to be carried out by a database engine. 

6. That on or before September 8, 1999, in the United States, a WTO member country, we 
conceived a method for enabling the generation of an updated web-page for storage in 
one of a plurality of cache servers, the method comprising: implementing programmable 
rules executing on each of the plurality of cache servers, each programmable rule 
defining a triggering event associated with its corresponding cache server, the occurrence 
of the triggering event being indicative of the existence of an obsolete portion of the web- 
page stored in the corresponding cache server; detecting an occurrence of a triggering 
event at a particular cache server selected from the plurality of cache servers; in response 
to the occurrence of the triggering event, causing the particular cache server to request an 
update of the obsolete portion; and receiving an updated portion of the web-page for 
storage at the particular cache server, wherein the method further includes providing an 
assembly script containing instructions for assembling constituent potions of a web-page 
and the updated portions into an updated web-page. 



7. 



That on or before September 8, 1999, in the United States, a WTO member country, we 
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conceived a web-serving system comprising: a plurality of cache servers each having a 
corresponding cache memory; and a cache manager in communication with the 
corresponding cache memory for controlling content of the corresponding cache memory, 
the cache manager being configured to execute a programmable script, the script being 
configured for detecting the occurrence of a triggering event, and in response to detection 
of the triggering event, causing the cache manager to request an update of the content of 
the cache memory, wherein the web-serving system further comprised a page assembler 
executing on the cache server, the page assembler containing instructions for assembling 
constituent portions of a web-page into a web-page 

8. That on or before September 8, 1999, in the United States, a WTO member country, we 
conceived a computer-readable medium having encoded thereon software for updating 
web-pages stored in caches, each cache being associated with a corresponding cache 
server from a plurality of cache serves, the software comprising instructions for: 
implementing programmable rules executing on each of the plurality of cache servers, 
each programmable rule defining a triggering event associated with its corresponding 
cache server, the occurrence of the triggering event being indicative of the existence of an 
obsolete portion of the web-page stored in the corresponding cache server; detecting an 
occurrence of a triggering event at a particular cache server selected from the plurality of 
cache servers; in response to the occurrence of the triggering event, causing the particular 
cache server to request an update of the obsolete portion; and receiving an updated 
portion of the web-page for storage at the particular cache server, wherein the computer- 
readable medium further comprised instructions for assembling constituent portions of a 
web-page and the updated portion into an updated web-page. 

9. That as evidence of my conception, I have enclosed herewith: 



Exhibit A, which is a copy of a the first six pages of an email string provided to a 
private focus group of users who agreed to assist us in testing our invention, which 
we named "DBFX;" 
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Exhibit B, which is a copy of the first four pages of a document I prepared to describe 
architecture notes and design and implementation decisions for DBFX; 

Exhibit C, which is a copy of the first four pages of a document I prepared to describe 
certain environmental variables, script tags, and attribute names used during 
processing of DBFX scripts; and 

Exhibit D, which is an exemplary DBFX script. 

Exhibit E, which is a "read me" file having a redacted date on line 3. Between lines 21 
and 35, the "read me" file refers to the files "page.dbfx," "ad. lasso," and 
"allemployees.lasso", the contents of which are shown in Exhibits F, G, and H. 

Exhibit F, which shows contents of the file "ad.lasso" referred to in Exhibit E. The file 
"ad.lassso" incorporates instructions for formulating a database query to a LassoSoft 
database named "dbfxadsample.fp3". The database query is submitted to a 
LassoSoft database engine to retrieve data stored in the fields "imagename", 
"adtext", and "clickURL" and to place that data in a web page created by a DBFX 
file described in Exhibit H. 

Exhibit G, which shows contents of the file "allemployees.lasso" referred to in Exhibit 
E. The file "allemployees.lasso" incorporates instructions for formulating a database 
query to a LassoSoft database named "employees.fp3". The database query is 
submitted to the Lasso database engine to retrieve data stored in fields such as "First 
Name", "Last Name", and "Home Page". The retrieved data is inserted into a web 
page created by a DBFX file described in Exhibit H. 

Exhibit H, which shows contents of the file "page.dbfx" referred to in Exhibit E. The 
file "page.dbfx" is an assembly script that contains instructions for assembling 
updated portions, namely the results of the database query formulated by 
"allemployee.lasso" and constituent portions, namely the title, the additional text, 
and the results of the database query formulated by "ad.lasso," into a web page 
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entitled "AdSample Page." The line "DBFX.CACHE.TTL="+01:00:00" indicates the 
frequency of update. 

10. That the following table sets forth support for the features of the invention claimed in 
claim 6 and the corresponding features in claim 24. 



CLAIM LIMITATION 


SUPPORT FOR CONCEPTION 


A method for enabling the generation of an updated web-page for storage in one of a plurality of 
cache servers, said method comprising: 


implementing programmable rules executing 
on each of the plurality of cache servers, each 
programmable rule defining a triggering event 
associated with its corresponding cache server, 
the occurrence of the triggering event being 
indicative of the existence of an obsolete 
portion of said web-page stored in said 
corresponding cache server; 


Exhibit A: page 6 "There's even a simple IF- 
ELSE-ENDIF syntax, so you can make up your 
won rules." 

Exhibit A: page 2, "DBFX is extremely flexible 
in letting you create intelligent cache- 
management rules that keep all your queries 
and databases in sync." 

Exhibit A, page 2: "DBFX lets you 
transparently forward database queries from 
your main server to a second server." 

Exhibit B: page 3, bottom of page "DBFX is 
controlled by real or synthesized "DBFX files" 
which contain instructions for modifying the 
request environment and specifying the action 
to take. 

Exhibit C: page 2, see syntax for "IF" at 
bottom of page. 


detecting an occurrence of a triggering event at 
a particular cache server selected from the 
plurality of cache servers; 


This would be whatever condition is specified 
in any of the "IF" statements above. For 
example, see Exhibit A: page 5, "You can 
easily set up any combination of: - specify a 
fixed amount of time to cache". See also 
Exhibit D sample "if statements. 
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in response to the occurrence of said triggering 
event, causing said particular cache server to 
request an update of said obsolete portion; and 


Exhibit D "decache" command executed. See 
also Exhibit A, page 5 referring to pre-cache 
and de-cache instructions, as well as ability to 
include or exclude any subset of queries from 
DBFX caching or processing. 

Exhibit B, page 4 "The [DBFX] file may also 
specify that DBFX should retrieve the data, 
flush the data, issue a redirect, etc." 


receiving an updated portion of said web-page 
for storage at said particular cache server. 


See Exhibit A page 5. This is the natural 
consequence of the retrieve option specified in 
Exhibit B, page 4. 


wherein requesting an update comprises 
formulating a database query to be carried out 
by a database engine. 


See the Lasso files in Exhibits F and G, each of 
which formulates a database query that, when 
executed by a LassoSoft database engine, 
retrieves records from selected fields of a 
specified LassoSoft database. 



1 1 . That the following table sets forth support for the features of the invention claimed in 
claim 7 and the corresponding features in claim 25. 



CLAIM LIMITATION j SUPPORT FOR CONCEPTION ~ 
A method for enabling the generation of an updated web-page for storage in one of a plurality of 
cache servers, said method comprising: 
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implementing programmable rules executing 
on each of the plurality of cache servers, each 
programmable rule defining a triggering event 
associated with its corresponding cache server, 
the occurrence of the triggering event being 
indicative of the existence of an obsolete 
portion of said web-page stored in said 
corresponding cache server; 


Exhibit A: page 6 "There's even a simple IF- 
ELSE-ENDIF syntax, so you can make up your 
won rules." 

Exhibit A: page 2, "DBFX is extremely flexible 
in letting you create intelligent cache- 
management rules that keep all your queries 
and databases in sync." 

Exhibit A, page 2: "DBFX lets you 
transparently forward database queries from 
your main server to a second server." 

Exhibit B: page 3, bottom of page "DBFX is 
controlled by real or synthesized "DBFX files" 
which contain instructions for modifying the 
request environment and specifying the action 
to take. 

Exhibit C: page 2, see syntax for "IF" at 
bottom of page. 


detecting an occurrence of a triggering event at 
a particular cache server selected from the 
plurality of cache servers; 


This would be whatever condition is specified 
in any of the "IF" statements above. For 
example, see Exhibit A: page 5, "You can 
easily set up any combination of: - specify a 
fixed amount of time to cache". See also 
Exhibit D sample "if statements. 


in response to the occurrence of said triggering 
event, causing said particular cache server to 
request an update of said obsolete portion; and 


Exhibit D "decache" command executed. See 
also Exhibit A, page 5 referring to pre-cache 
and de-cache instructions, as well as ability to 
include or exclude any subset of queries from 
DBFX caching or processing. 

Exhibit B, page 4 "The [DBFX] file may also 
specify that DBFX should retrieve the data, 
flush the data, issue a redirect, etc." 


receiving an updated portion of said web-page 
for storage at said particular cache server. 


See Exhibit A page 5. This is the natural 
consequence of the retrieve option specified in 
Exhibit B, page 4. 



Applicant : Guenther 
Serial No. : 09/737,656 
Filed : December 18, 2000 
Page : 8 of 9 


Attorney's Docket No.: 1 1 125-014001 


wherein said method further comprises 
providing an assembly script containing 
instructions for assembling constituent portions 
of a web-page and said updated portion into an 
updated web-page 


See Exhibit H, which shows a DBFX file that 
contains instructions for assembling the results 
of two database queries made by the two Lasso 
files in Exhibits into an updated web page. 


12. That the following table sets forth support for the features of the invention claimed in 
claim 17. 


CLAIM LIMITATION 


SUPPORT FOR CONCEPTION 


A web-serving system comprising: 




a plurality of cache servers each having a 
corresponding cache memory; and 


Prior art, needs no evidence of conception. 


a cache manager in communication with said 
corresponding cache memory for controlling 
content of said corresponding cache memory, 
said cache manager being configured to 
execute a programmable script, said script 
being configured for detecting the occurrence 
of a triggering event, and in response to 
detection of said triggering event, causing said 
cache manager to request an update of said 
content of said cache memory. 


Cache manager is whatever executes the script 
referred to in claim 1 . 


further comprising a page assembler executing 
on said cache server, the page assembler 
containing instructions for assembbng 
constituent portions of a web-page into a web- 
page. 


See Exhibit H, which shows a DBFX file that 
functions as a page assembler for execution on 
a cache server. The DBFX file includes 
instructions for assembling the results of two 
database queries (formulated by the Lasso files 
in Exhibits F and G) into a web page. 



13. That on or before September 8, 1999, in the United States, a WTO member country, we 
reduced our invention to practice by writing software for carrying out the method steps 
recited in claim 6, and encoding the software into a computer readable medium as recited 
in claim 24. 
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14. That on or before September 8, 1999, in the United States, a WTO member country, we 
reduced our invention to practice by writing software for carrying out the method steps 
recited in claim 7, and encoding the software into a computer readable medium as recited 
in claim 25. 

1 5 . That on or before September 8, 1 999, in the United States, a WTO member country, we 
reduced our invention to practice by implementing a system as recited in claim 17. 

16. That the dates in all attached Exhibits have been redacted, but that all the redacted dates 
were on or before September 8, 1999. 

17. I hereby declare that all statements made herein of my own knowledge are true and that 
all statements made on information and belief are believed to be true. I further declare 
that these statements were made with the knowledge that willful false statements and the 
like so made are punishable by fine or imprisonment, under Section 1001 of Title 18 of 
the United States Code, and that such willful false statements may jeopardize the validity 
of the application or any patent issuing thereon. 



Sept 27, 2007- 



Date 



-/Benjamin W. Wvckoff/ 



Benjamin W. Wyckoff 
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Received from 205.1 36.66.214 by cleanvay.com 

with S MTP (Eudora Int ernet Mail Server 1.2); mmemmm 16:1.1:23 -05^ 

From: krtegS5man@clearway.com (Mark Kriegsnian) 
Subject: Web database accelerator (DBFX) Beta list 
To: dbfx-beta@clearA'ay.co«i 
Mime-Version: 1.0 

Content-Type: text/plain; eharset ;:: "us-ascii" 
Precedence: Bulk 

X-listserver; ListSTAR vl ,1 by StarNine Technologies, a Quarterdeck Company 
Repiy-To: dbfic-beta@cleaway.coin 
Errors-To: dbfx-beta@cleaway.com 

WELCOME'! 

Welcome to the privateFocusj©raup for ClearWay Tedinologies* 
new accelerator iSr VVe^atSteelniblisbirig, codenamed "DBFX" 

DBFX speeds Web database queries, and gives you powerful, 
and flexible new options for how you publish your databases 
on the Web. 



YOU ARE NOW PART OF THE FOCUS GROUP 



You have been added to the DBFX-Beta maiMhg li st because 
you asked to be added, or because you expressed an interest 
in a product that accelerates Web database publishing. 

This small, closed mailing list will be used to tell you 
where to download the new software, and for discussions 
of how to use it for your database-publishing applications. 



NON-MSCLOSURB 



By electing to participate s this focus group, you will be in 
possession of proprietary,, confidential, and trade secret information 
belonging to ClearWay Technologies, inc. You must not disclose 
the content, or the nature, or character of the information discussed 
here to any third party without prior wri tten consent from 
ClearWay Technologies, Inc. The sole exception is information 
that you are in prior possession of, or that becomes public through 
other means. You will be held liable for all damages arising 



I 



directly or indirectly from your actions if you disclose proiected 
information 

If you cannot abide by this plain-language non-disclosure agreement, 
contact me at ones at <kricgsman@ciearway.com> and you will be 
removed from the focus group and this mailing list. 



WHAT THE DBFX SOFTWARE DOES 



D8FX pwides four new functions for your Web database: 

3L Caching. The results of the most frequently/recently 
requested queries are cached, greatly speeding publishing 
applications using a database. DBFX is extremely 
flexible in letting you create intelligent cache-management 
rules that keep all your queries and databases in sync. 

2. Virtual Queries, DBFX lets you create virtual URL 
hierarchies that actually translate into database queries. 
This allows you to hide the structure and nature of your 
database system, and can allow Web crawlers to index your 
databased content. 

3. Forwarding. DBFX lets you transparently forward database 
queries from your main server to a second server, via TCP/IP. 
This allows you to move your database to a second computer 
without exposing the 'inner' structure to the outside world. 

4. Data Insertion. DBFX lets you embed data from your databases 
on any NetCloak or WebSTAR SSI page with a few simple tags. 
Thus, you could use SSI for a raiarmg-ad-banner system, 

and still serve Web content from your database through the 
extremely fast DBFX cache. 



DBFX works with: Lasso, Tango, WebCatalog, WebFM, FileMaker, and 
Other popular Web databases. It's a WebSTAR plug-in, and will also 
be available for WebTen and other W* API-compatible servers. An 
Apache version is also in the works. 

That* s it in a nutshell. If you are doing "Web Database Publishing", 
then DBFX will probably make your job easier, and you Web site 
run much faster. 
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If you are using a Web database only for a highly-interactive 
application (such as a shopping cart system), DBFX will not 
accelerate it, bui you may want to took at the other features as well. 



HOW AND WHEN DO I GET THE SOFTWARE? 



The software will be available for download later this week. You 
will be informed on this mailing list 

We expect every member of the focus group to be an active participant 
in this discussion and the refinement of DBFX. If you cannot 
spare the time (a few hours a week, for about four weeks), or if 
you will not have any opportunity to try DBFX, or if you simply 
don't want to do this now, just drop me an e-mail. 



DONT WAMT TO BE PART OF THE FOCUS GROUP? 



If you wish to be removed from the focus group, e-mail me directly 
at <kriegsman(%;learway.coft'i> You cannot remove yourself 



OK" Welcome to the list, and thank you for helping us out 

1 hope that all this sounds interesting to you, and if it does, Pm 
sure you have a million questions... anyone want to kick off the 
discussion based on the four features identified above (Caching, 
Forwarding, Virtual Queries, Data Insertion) ? 

I'm waiting for "how does n know how long to keep a query cached?" ! 



-Mark Kriegsman 

kriegsman@clearway.com 

1-617-262-4006 



R^ceived:^m^ 
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with SMTP (Eudora internet Mai! Server 1.2);<-vaMtfN«riMKr 16:19:17 -0500 

Date: %!&fflmmm& 22: 1 1 :3 1 -0100 

Message-id: <v04 1 03dG5b2c953ab3f7c@[ 195.198.39.1 00]> 

From: "Joakim Jardenberg [listmail]" <inbox@mfinit.se> 

Subject: Re: Web database accelerator (DBFX) Beta list 

To: dbfs-beta@cle3arway.c0m 

Mtme- Version: 1.0 

Content-Type: text/plain. ; format- 'flowed" 
Precedence: Bulk 

X-Listserver: ListSTAR vl.l by SiarNine Technologies, a Quarterdeck Company 
Reply-To: dbfx-beta@cleaway.com 
Errors-To: dbfx-beta@cleaway.com 

riitfMM* klockan 16.03 -0500, skrev Mark Kriegsman: 

> I hope that all this sounds interesting to you, and if it does, I'm 

> sure you have a million questions... anyone want to kick off the 

> discussion based on the four features identified above (Caching, 

> Forwarding, Virtual Queries, Data Insertion) ? 

how does it know how long to keep a query cached? 

;-)' 

Very excited about the next CWKA (Clearway killer app) 

Also, note, the return address i missing the "r" in clearway 
(t!fef)(-beta@cieaway, com) 

/Jocks 



Joakim Jardenberg: lrttp.VMww.mfimt.Se/.sig 

innehCEllet 1 deita brcv fXEr ime utan sSrskilt 
medgivande publiceras eller pCE annat s§tt spridas 

From ???@???; iMifTlllii. 1 6:42:00*—^ 

Received: from 205. 1 36.66.2 14 by clearway.com 

with SMTP (Eudora Internet Mail Server 1.2); N«0BP*MM 1 .6:43:43 -0500 
Date: Mon,«HNM» 1 16:36:27 -0500 
Message-Id: <v02 1 40b06b2c959c6e323@f 205. 1 36,66. 1 94]> 
From: kriegsman@clearway.com (Mark Kriegsman) 
Subject: Re: Web database accelerator (DBFX) Beta list 
To: db fx-beta@ciearway.com 
Minie-Version: 1 .0 

Content-Type: texi/plain; charset- 'us-ascii*' 
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Precedence: Bulk 

X-Listserver: ListSTAR vl.l by StarNine Technologies, a Quarterdeck Company 
Reply-To: dbfx-heta@clearwaycom 
Errors-To : dbfx-beti5@cicanvay.com 

At 10:11 PM ox^Mi^ Joakini Jardenberg [listmaiij wrote: 

- *B>fcP*&lockan 16.03 -0500, skrev Mark Kriegsroan: 

> > ! hope that all this sounds interesting to you, and if it does, I'm 

> > sure you have a million questions... anyone want to kick off the 

> > discussion based on the four features identified above (Caching. 

> > Forwarding, Virtual Queries, Data Insertion) ? 
> 

> how does it know how long to keep a query cached? 

>;-) 



Good question! You can configure DBFX to cache queries as long (or as 
short, or as Intelligently) as you wish. 

You can easily set up any combination of: 

•- specify a fixed amount of time to cache (can vary per query, and globall y) 
such as "one hour by default, hut only 5 minutes for one special page" 

- specify that when a query says M aetion : 4nsert" (or anything else you wish), 
thai DBFX will then flush any cached records from that same database. 
This lets you trap' any INSERT, UPDATE, and DELETE events that happen 
through Web-based interfaces. 

- de-cache and/or pre-cache certain queries when the _Web_server's_ caches 
are flushed 

- respect or ignore the "Expires" date in the original query result 

- respect or ignore any No-cache directives in the browser request 

- de-cache and/or pre-eache &ty queries you wish when a specific XML is 
requested (and you can defined any number of URLs for controlling the 
cache any way you wish...) 



include or exclude any set or subset of your queries from DBFX 
caching or processing; DBFX only caches queries you designate 



There's even a simplelF-ELSE-ENDlF syntax, so you can make up your own rules. 



Hopefully, this will ail be clearer with the software in front of you. But 
the general concept is that you can speciftfy with great ease and 
flexibility how long you want each query cached. 

And thanks .for asking, Jcakiro. 

-Mark 



Received: from 205. 1 36.66.21 4 by ciearway.com 

with SMTP (Eudora Internet Mail Server 1.2); *mmm&HHt) 17:08:03 -0500 

Date: Mon. MM 22:50:47 +0100 

Message-Id: <v04103d01b2c95c91 5S42@[i 95. 1 98.39. 100]> 

From: "Joakim Jardenberg [Hstmail]" <inbQx@infinit.se> 

Subject: Re: Web database accelerator (DBFX) Seta list 

To: dbfic-beta@clearway.com 

Mime- Version: 1.0 

Content-Type: text/plain ; format= ; "flowed" 
Precedence: Bulk 

X-Listserver: ListSTAR vl.l by StarNine Technologies, a Quarterdeck Company 
Reply-To: dbfx-beta@clearway.coin 
Errors-To: db&-bcta@clearway,com 

klockan 16.36 -0500, skrev Mark Kriegsraan: 

> There's even & simple 3F-ELSE-ENDIF syntax, so you can make up 

> your own rules. 

WOW! 

That is deSnetly more advanced then what I was looking for on 
Lasso-Talk almost a year ago, I quote myself: 



As one who is a sucker for "semi-dynamic" publishing solutions a 
LARGE cache in Lasso would be great. 

A typical url in one of our systems point to a formatfile with a 
inline that uses the form_param to retrive the article (ie: 
http://w'ww^mydomajn.eom/dispky.lasso?show=136 
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DBFX Design Notss-M 

This document contains sortie architecture notes arid design 
and implementation decisions for DBFX. 



Server/Client Model Theory 
(Tills is classic middleware) 

DBFX is based internally on a Server/Client Model The primary 
task of DBFX is to SERVE pages to clients making requests to the 
web server. Internally, DBFX tarns around and acts as a CLIENT, 
getting data from a variety of other sources. 

As a server, DBFX may get requests in a number of ways, including, 
but not limited to, as a W* API Plug-In in the CGI role, as a PTXO 
source or processor, and as a W* SSI Tag handler. 

As a client, DBFX may get data in a number of ways, including, 
but not limited to, P1XO to other plug-ins running in the 
same server, TCP/IP to the same server or other servers 
(running anywhere), W* SSI specific services, Apple Events to 
CGIs, FasfCGl. 

The internal architecture turns the various requests contexts 
into a normalised request parameter block, with most of the 
data stored in an Environment data structure (Passive VarEnv). 
Similarly, returning data back to the clients is hidden through 
use of an abstract Emitter object. This way, regardless of the 
request method (e.g., PIXO, W*API CGI), we can process the request 
in the same way after normalizing it. The REQUEST code is new 
to DBFX, but based on existing code, technology, and concepts. 

The client code is handled in a similar way, with much of the 
code borrowed from the FireSite client technology. An HTTPRequest 
class (and its derived classes) provides a uniform interface to 
performing HTTP requests and handling the responses. Current 
clients support TCP/IP and PFXO. Extending the functionality to 
include AppleEvents or other methods is relatively straightforward, 
and does not alter the architecture of the system at all. 
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Server/Client Model Implementation 



This section descri bes the architecture in terms of the specific 
classes and Bow of control. 



Request classes: 

Class DBFXRequestPB (virtual base class) 

class DBFXCGIRequestPB : public DBFXRequestPB 
class DBFXPiXORequestPB : public DBFXRequestPB 
class DBFXSSIRequestPB : public DBFXReqaestPB 

Emitter classes: 

(These may change, depending on how the cache is implement) 
class SimpleEmitter 

class WSAPlEmitter : public SimpleEmitter 

class BufferedBmitter : public SimpleEmitter 

Client classes: 

(There are a few levels here, to take advantage of existing code) 
class DBFXClient 

class DBFXSimpieHTTPClient : public DBFXClient (prototype/test class) 
class DBFXBTTPRequestClient : public DBFXGSiertt 

Client classes, level 2: 

(class DBFXHTTPRequestClient manages different HTTPRequest derived classes) 
class HTTPRequest 

class imTRequestTCP : public HTTPRequest 

class HTTPRequestPLXO : public HTTPRequest 

The baste flow is as follows: 



Reque^JBntryJ^int 

custom etilry point processing 

create appropriate derived class of DBFXRequestPB 

cailDBFXRequestPB.ProeessReques^) 

Itiitiali7.eEnv(serv'erField); 

PopulateEnvQ; 

RunDBFX.Ihterpreter(); 

Execute(O)* 

// Note - cache hits wilt (probably), be processed here 
based on Env, prepare a new request, allocate new client class, 
execute the request, and the result is written to the emitter 
on the DBFXRequestPB. 
EmitterQ.flushO; 
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// Note - cache insertion will (probably) happen here, 
perform custom request cleanup 

(may include actually banding data back to client, if not streaming) 
custom entry point exit-processing 

Some specific entry points that are cprrently implemented are 
as follows; 

PIXO Server: 

PIXO..RunResaK PLXOEntr><void * pixoPB); 
cast pixoPB to appropriate type 
create thread context 
callPEXOAetion{pixoPB) 
if(statns request) 

return OKToRun 

else { 

get server header field for responses 
DBFXPLXORequestPB dbrx(pLxoPB): 
dbfx.ProcessRequest(serverField); 

// the response is buffered by the Emitter, because PIXO works in "page 

mode" 

pixoResult ~ db&.StoreRestiitOriPIXOPB0; 

I 

return pixoResult 
handle exceptions 
return pixo, result 

W*API CGI Role ,'Servcn 
WSAPlJMspateh 

if(WSAPLRun) { 

ProcessRunCaH (commandPir); 

get server header field for responses 
if admin request, handle directly 
DBFXCGIRequestPB dbtx(pb); 
dbfx«ProcessReqtiest{ser\ ? erField); 

// the response is streamed back to the client by the Emitter as it is 

generated 

return WSAPUMoErr; 



DBFX "Command" Files 

DBFX is controlled by real or synthesized "DBFX files" which contain 
instructions for modifying the request environment and specifying the 
action to take. 
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Specifically, a DBFX file might set the host name, scriptnarne, path and search 
args describing the location of the desired content. The file may also specify 
that DBFX should retrive the data, flush the data, issue a redirect, etc. 

As a DBFX server receives a request, it populates an environment with the 
request parameters. The original request may identify a physical DBFX file 
on disk. If so, the file contents are parsed, with the tag-handler side effects 
possibly modifying the request environment. Also, the original request (e.g., for 
PXXG or SSI) may include DBFX commands in the request, so there is no physical 
file .to load. In this case, the commands are similarly processed for side effect. 
Lastly, there may be global rules applied to the request which may result in 
some other DBFX file or command set to be processed. For instance, a "virtual UM." 
may not refer to a real file, but may contain information that points to an 
alternate DBFX command file. 

[n all cases, the request environment may be modified by commands in a 
real or virtual DBFX command file. 

After the DBFX command file has been processed, the environment is handed 
off to the DBFX Client manager. 

(Note - the DBFX command "file" is processed during the RunDBFXInterpreter 
phase of server request handling) 



Cache 

There are no cache design notes at this time, as the design is 
still in flux. 



§ 
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BenWyckoff 




This document contains' names (and some semantics) of the environment 
variables . DBFX Script Tag and attribute names, and SSI Tag Handler 
tag arid attribute names used during DBFX processing. 

It is intended that this document be reviewed with an eye towards 
renaming many of the symbols to improve overall clarity. 



There are three broad categories of symbol names that the end user 

sees; DBFX Script Tag and Attribute names (DBFX Tag Names), 

DBFX Script Variable Names (DBFX Var Names), and DBFX SSI Tag Handler 

Tag and Attribute Names (SSI Tag Names). The DBFX Var Names are further 

broken down into categories. (Yet another class of symbols is constants 

- 1*0 lump them in with DBFX Var Names..,) 

The naming conventions should be similar, but they are discussed 
separately below. 



SSI Tag Names 

DBFX registers "tag handlers" with WebSTAR SSI, and SSI calls the 
registered function when it encounters the specified tags. All of 
the attribute/value pairs in the tag are passed through to DBFX 
but some of them hate special semantics and are copied/coerced into 
other internal environment variables. 

Online documentation is currently at <http://w^vw.c^^^ 

Tag Names: 

EXEC DBFX 

EXECJDBFXJSS! - like EXECDBFX, except SSI processes the results 

The above two tags take all of their parameters as attribute/value pairs - there 
is no closing lag. 
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EXEC DBFX SCRIPT and /EXEC DBFX SCRIPT 

EXEC DBFX SCRIPT SSI and /EXEC DBFX SCRIPT SSI 



The .. SCRIPT tag names do .accept attribute/value pairs, but also interpret the 
text between the begin and end tags as the DBFX script to be executed, The 
„SSI variant causes SSI to process the results for additional SSI tags. 

The BXEC_D8FX* tag handler sets all of the attribute/vahie pairs in the environment 
as 'TORM.aitrname'' variables, Some of the attributes are special cases as defined 
below: 

PATE^'db&Jilejtame" - the "SCRJi>T„NAME" of the file-based DBFX script to execute, 
(does not apply to the _SCRfl?T variants) 

STARTBEFORE="delimiter_text" 
STARTAFrER= ,: delirruterJext" 
ENDBEFORE~"delirniter text" 
ENDAFFER«"deiimiterJext H 

The start/end attributes arc used internally to control how much of the enti ty is 
returned to SSI from the tag handler. Note that the start/end variables may be set 
directly in the ^SCRIPT variants asmg<S£T STARTBEFORE-"..."> commands in the 
script body as well as passed as attribute/Value pairs in the tag body. 



DBFX Tag Names 

The DBFX Script Language is documented online at 
<hitp:/V\vmvxfe^ 



<D1SPLAYJ*1ESSA<3E "texf > 
<SET name - expression> 



<IF expression> „. <ELSE> ... <ENDIF> 
(also </IF> as synonym for <endif>) 



<DECACHE , *match_string"> 



<DECACHB_REGEXP*Vcgi3lar_expression m string"> 



<PRECACHE HREF-'urF MEmOF^'method" POSTARGS^posi_axg.^{riiig' [ .„> 
The ... means you can also specify arbitrary attribute/value pairs in the 
PRECACHE tag. DBFX assigns the value into a variable with the same name as 
the attribute (NOT as FORM attfname). This is particularly useful for specifying 
cache-control values for the individual preeache request, such as DBFX.CACHE.TTL. 



Hie . means the same thing as in PRECACHE. In addition the START/END tags 
used in EXEC JD8FX are valid here as well. 



<RETRIEVE_CONTENT HREF-'urF METHOD^'method" POSTARGS-"post . asjaring" 
...> 

This is like INSERT^ CONTENT (including the START/END tags), phis the 
"INTOVAR* attribute name is special - it tells DBFX what env variable to store 
the result in. 



<INS ERTjSTRING "va!ue ,! > 



<REDIREGT HREP ::: "ur i "> 

Internally (i.e., not documented), DBFX also accepts "URf", "URL"', "LOCATION" as 
synonyms for the "HREF" attribute name. 



<ON_ERROR ...> 

// attribute names are not yet documented online*.. 
<ON_ERROR ACTION- "REDIRECT" j "SERVE_FROM_CACHE ,> 
URI*xxx> 

Synonyms for URI are "ORL" and "LOCATION" 



<SYSBEEP> 



<MATQI_REGEXP ...> 

// attribute names are not yet documented online... 

// in fact, the regexp behavior and is not yet documented online either 

C4-hased attributes: "SRC/'REGEXP", "INTO", 

DBFX custom attr "IGNORECASE" - causes DBFX to (incorrectly) ignore ease 
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whai doing the regexp match - defaults to "FALSE" 

INTO defaults to "MATCH.", and defines the prefix for the regexp match vats 



<INCLUDE "path"> 

(DBFXINCLUDE is a synonv-m for INCLUDE) 



<DWMB- SITE U1NAME- 'name" PATH«"siteroot« SCWrSPATH«"seriptsf0lder" 
fiOSTNAMlS==="hostnameJist"> 



<RFJPEAT> and </REPEAT> 

// completely undocumented in DBFX (but identical to C4 usage) 

// needed for Admin, might as well document as part o f the DBFX Script Language. 



DBFX Var Names 

This major section encompasses DBFX script environment variable 
names and values. There are 3 main types of DBFX scripts: 
Automatic scripts, Filter Scripts, and Request Scripts. 

Automatic seriptsindude startup, shutdown, flush, every-minute etc 
md precaqhe. The STARTUP and SHUTDOWN scripts run in the global 
environment by design. Ail other scripts run in a temporary env that 
has the global env as a parent 

Filter Scripts run at W*API filter time, and do not generate content. 

Request Scripts run at "CGI" time, and are responsible for directly 
or indireotly generating content to return to the client. 



Global Variables 



Cache Control 

(documented online at http://mv-w.cleawayxQm.^ 

There are global variables that determine default cache behavior, and 
there are variables that can modify cache behavior on a per-request or 
per-entity basis. 
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<!— 

this script is run when DBFX can't find the requested 
file, and the ills it tried to find ended in "Jasso.dbfx" 

This assumes your lasso URLs contain one of 
-Search--... 
-Updates... 

-Delete™... 

if Update, Add, or Delete, decache all cached pages. 
The process the request. 

<if "[form .-update]" ne "*> 

<decache 7"> 

<endif> 

<if "[forra.-add]" ne 
<decache "/"> 
<endif> 

<if "[forni.-delete]" ne 
<<iecache "/"> 
<endif> 



<!-- 

Remove the last suffix (which is ".dbfx" now) from the scriptjiame variable. 
The scriptnarne here is the URL DBFX will request and cache 

— >■ 

<setscript_name-'tpath.withoBtsuffix.-0]'^ 

<display > message "virtual dbfx script restoring script name to [path.withoytsufllx.-01"> 



This archive contains just a few files, designed to show a 
Dynamic Ad Rotation system with cached content, using the 
new DBFX Page Generation feature. 

For more information, checkout 

the DBFX docs online at <http://www.clearway.com/dbfx/docs/>. The docs 
provide more samples, explanations, FAQs, info for making 
more complicated scripts, and debugging info. 

Also, within DBFX, browse to /pi_admin.DBFX for some simple 
admin options, including the ability to activate diagnostic 
messages. 

Note: This sample assumes only one default site is defined. 



included Files: 

page.dbfx - a DBFX page that uses INSERT_C0NTENT tags to build 
a page for the client. One of the tags gets dynamic data, the 
other gets cached data. 

dbfxadsample.fp3 - a FileMaker database with 6 add banners defined 

ad. lasso - a lasso query that generates ad banners 

all employees. las so - a lasso query that gets a list of all employees 
in the sample Lasso Employees database 

images - a folder with the images for the ad system 



Setup instructions 

(1) Follow the CommonFiles ReadMe Setup instructions 

(2) install the Lasso Employees database, and open it. 

(3) Place the AdSample folder in a site on your server that is configured 
to use DBFX. 



Use instructions 

(1) Follow the CommonFiles ReadMe use instructions 

(2) Surf to the /adsample/page.dbfx URL, using whatever path prefix matches 
the folder it was installed in. 

(3) Note in the DBFX console window that the two searches were done, through Pixo 
and Lasso. Only the second is cached. 

(4) Reload the same URL, check the console window, and see that the first query 

is dynamic, and the second results in a cached page being returned. Keep reloading 
the page and note that the ad banners change each time. 
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AD- LASSO.tXt 

<HTML> 
<HEAD> 

<TITLE>Get AD</TITLE> 

</HEAD> 

<BODY BGCOLOR="whl'te"> 

<! — Begin Rotating Ad Code — > 

ADSTART 

[inline: database=dbfxadsample.fp3, layout=Detail , random] 
<center> 

<A HREF="[field:clickURL]"> 

<IMG SRC="images/[field:imagename]" border=0 alt=" [field :adtext] "><br> 
<f ont si ze=-l f ace="geneva , Re! veti ca , swi ss"> [f i el d : adtext] </f ontx/a> 
</center> 
[/inline] 

ADEND 

<! — End Rotating Ad Code — > 

</BODY> 
</HTML> 
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all employees lasso.txt 

<HTML> 
<HEAD> 

<TITLE>Get AD</TITLE> 

</HEAD> 

<BODY BGCOLOR="white"> 

<! — Begin Rotating Ad Code — > 

[inline: database=employees.fp3, layout=Detail , findall] 
<ldml tag="records"> 

<TR> 

<TD COLSPAN="3"xHRx/TD> 

</TR> 
<TR> 

<TD WIDTH="120"> 

<A href=" [1 i nk_detai 1 : 1 ayout= ' detai 1 ' , 
response= 'detail .html'] "xBxLDML tag="field: 'First Name'"> <LDML tag="field: 'Last 
Name' "x/Bx/A> 

<br> 

<LDML tag="field: group">, <ldml tag="field: 'shift'"> 

</TD> 

<TD WIDTH="300"> 

<A HREF="mail to: [field: 'email', encodeRaw ]"><ldml 
TAG="field: ' emai 1 '"></A> , 

<A HREF=" [field: 'Home Page', encodeRaw] "xLDML TAG="field: 

'Home Page'"x/A> 

<BR> en: <ldml tag="field: 'employee number '">, ssn: <ldml 
tag="field: 'social security number'">, <ldml tag="field: 'hire date'"> 

</TD> 

</TR> 

</LDML> 

[/inline] 

<! — End Rotating Ad Code — > 

</BODY> 
</HTML> 
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page dbfx.txt 

<html> 
<head> 

<title>AdSample Page</title> 

</head> 

<body> 

<insert_content 

href="ad. lasso" 

STARTAFTER="ADSTART" endbefore="adend" 
DBFX_RESPONSE_CACHE_CONTROL="no-cache" 
DBFX_REQUEST_CACHE_CONTROL=" no- cache" 

> 

<p>The text below is cached from the employees database. 
<insert_content 

href="al 1 empl oyees . 1 asso" 

STARTA FT E R= < BOD Y> ENDBEFORE="</BODY>" 
DBFX . CACHE . TTL="+01 : 00 : 00" 



</body> 
</html> 
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